RIDE_Init

This parameter determines how the interpreter should behave with respect to the RIDE protocol. Setting this configuration parameter on the machine that hosts the interpreter enables the interpreter-RIDE connection.

RIDE_Init can only be used to specify a limited number of RIDE configuration options; the rest must be specified in a RIDE ini file. Full details describing how to configure RIDE, including using certificates to authenticate connections can be found in the RIDE User Guide.

The format of the value is:

 <setting> : <address> : <port>

setting is the action the interpreter should take. Valid values, which are case-insensitive, are as follows:

serve – listen for incoming connections
http - listen for an incoming request for Zero Footprint RIDE
connect – connect to the specified RIDE and end the session if this fails
poll – try to connect to the specified RIDE at regular intervals and reconnect if the connection is lost
config - specifies the name of the RIDE ini file to be used

If setting is serve or http then address specifies the address of an interface in the machine running the interpreter. If setting is connect or poll then address specifies the address of a machine running the RIDE. Valid address values are:

a resolvable name
an IPv4 or IPv6 address
empty – the local machine only
* - (valid only when setting is serve or http) the interpreter listens on all local network interfaces

port is the TCP port to listen on

Settings specified by the RIDE_Init configuration parameter take precedence over the same setting specified in the RIDE ini file. Note that the RIDE_Init configuration parameter can specify both config and one of serve, http, connect or poll. For example

  RIDE_INIT=serve:*:4502,config=/home/andys/.dyalog/secureride.ini

This is most useful when multiple interpreters need to be run, each with its own RIDE connection as each must have a separate port number.

Note that the RIDE_Init configuration parameter is set automatically when launching a new Dyalog Session from the RIDE.

Examples

To allow an incoming connection through any interface in the machine running the interpreter:

      RIDE_INIT=serve:*:4052

To allow incoming Zero Footprint RIDE connection through just one interface of the machine running the interpreter:

      RIDE_INIT=http:192.168.0.10:8080

To attempt to connect to RIDE running on my colleague's machine:

      RIDE_INIT=connect:pete.dyalog.com:4052